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Authorization  for  this  research  was  contract  no.  DAAK70-8  l-D-0052 ,  Task  no. 
0018  (Task  Order  to  a  competitive  contract  awarded  on  a  technical  basis).  The 
views,  opinions,  and/or  findings  contained  in  this  report  are  those  of  the 
authors  and  should  not  be  construed  as  an  official  Department  of  the  Army 
position,  policy  or  decision,  unless  so  designated  by  other  documentation. 
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This  user’s  manual  describes  the  execution  of  an  expert  system  for 
Software  Quality  Assurance  (SQA).  The  objective  of  the  expert  system  is  to 
capture  the  knowledge  of  experienced  SQA  engineers  in  order  to  properly  tailor 
a  Statement  of  Work.  To  achieve  this,  the  process  is  divided  into  components 
which  are  all  included  in  the  batch  file  called  SQA. BAT. 


The  primary  component  is  the  expert  system,  which  was  developed  using  the 
EXSYS  development  package  shell.  Before  execution  can  begin  the  -following 
files  must  be  located  in  the  same  directory  where  EXSYS  has  been  installed: 


SQA. BAT  —  the  batch  file 


SOFT .  RUL  — 

\ 

SOFT  .TXT  —  EXSYS  files  containing  the  expert  system 

/ 

SOFT. OUT  — 


SOW  —  Master  Statement  of  Work 


READER.COM  —  Turbo  Pascal  program  to  take  the  results  of  the  expert 
system  and  contruct  a  tailored  Statement  of  Work 


In  our  application,  the  directory  where  EXSYS  is  installed  is  C.’EXSYS. 

You  may  wish  to  call  it  whatever  you  like,  but  we  shall  refer  to  it  in  this 
manual  as  C: EXSYS.  After  logging  on  to  the  computer,  change  to  the  directory  _ 

b> 

where  EXSYS  is  installed: 


C:\CD  EXSYS 


Execution  begins  by  entering  SQA  at  the  prompt: 


$ o 


C:\EXSYS>SQA 


o  o  □ 

BRIGHT  CONTRAST  ON/QFF 


The  user  now  has  the  following  options: 


IF  line  #  - 
K  - 
C  - 
R  - 

*  t  - 

J  - 
H  - 


for  derivation  of  those  statements 
Known  data;  lists  the  values  for  all  the  variables 
Choices;  lists  the  values  for  all  the  choices 
Reference;  additional  text  or  information  about  the  rule 
to  view  the  previous  or  next  rule 

Jump;  enter  the  number  of  the  rule  you  wish  to  move  to 
Help;  EXSYS  help  text 


The  user  then  continues  through  the  questions  until  they  have  all  been 
answered. 


After  the  final  question,  the  program  sorts  the  results  and  writes  the 
information  to  a  file. 


Then  the  following  screen  appears  telling  the  user  that  all  of  his 


responses  have  been  saved  in  the  file  INPUT. 


Valun  btMd  on  0/1  ajmtm 


Ail  choice*  <A>»  only  if  value  >1  <G>,  Print  <P>,  Change  and  renai  <C> , 
rule*  uaad  <Um  nabar>,  Quit/aava  <Q> ,  Help  <H> ,  Dona  <D> : 


OO  O 

BRIGHT  CONTRAST  OM/QFF 


■13  is  an  example  of  possible  results  from  an  EXSYS  run.  EXSYS  displays 
the  results  of  all  the  choices  whose  value  is  greater  than  or  equal  to  one. 
These  values  are  not  important  to  the  user  and  he  should  not  be  concerned  with 
them.  The  screen  is  displayed  only  to  take  advantage  of  the  options  available. 
They  are  as  follows: 

A  -  lists  the  values  for  all  the  choices.  As  stated  above ,  these  are  of 
no  concern  to  the  user  and  should  be  ignored. 

G  -  lists  the  values  of  the  choices  if  greater  than  1.  Again,  these  are 
of  no  importance  to  the  user. 


P  -  Print;  this  enables  the  user  to  get  a  print  out  of  all  the  questions 
and  answers  of  his  session,  along  with  the  variables  and  the  choices. 


£  a 


i: 
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C  -  Change  and  rerun;  this  allows  the  user  to  change  one  or  more  of  his 
responses  and  rerun  the  program  to  observe  any  changes  in  the  results. 
Hie  previous  results  can  be  kept  for  comparison. 

Q  -  Quit/save;  exits  both  the  expert  system  and  the  batch  file. 

H  -  Help;  EXSYS  help  text. 

D  -  Done;  exits  the  expert  system  and  continues  with  the  batch  file. 


Further  details  and  explanations  about  EXSYS  and  the  expert  system  can  be 
found  in  the  EXSYS  manual. 


After  exiting  the  expert  system,  the  batch  file  calls  up  the  program 
READER.  This  program  is  written  is  Turbo  Pascal  and  uses  the  following  files: 


1.  SOW  -  Text  file  containing  the  master  Statement  of  Work.  Here  is  a 
sample : 


@10.00 


@20.00 


@100.00 


STATEMENT  OF  WORK 

BRDEC  SOFTWARE  DEVELOPMENT  AND  SOFTWARE  QUALITY  EVALUATION 
SCOPE  OF  SOFTWARE  DEVELOPMENT  AND  SOFTWARE  QUALITY  ASSURANCE  TASKS 


@200.00  General 

This  document  delineates  the  Government’s  requirements  for  scientific, 
engineering,  analysis,  and  technical  services  to  support  software  development 
and  software  quality  evaluation  for  BRDEC  (Belvoir  Research,  Development  and 
Engineering  Center)  mission-critical  computer  systems  software. 

@300.00  Scope  of  Work 

The  contractor  shall  provide  all  necessary  personnel,  supervision, 
management,  materials,  services,  equipment,  and  facilities  to  perform  software 
development  and .  etc. 


2.  RESULTS  -  the  results  from  the  expert  system  containing  the  numbers 
of  the  paragraphs  to  be  included  in  the  Statement  of  Work. 
Here  is  a  sample: 

914.000000 

915.000000 

917.000000 

918.000000 

921.000000 

922.000000 

1003.000000 

1004.000000 

1500.000000 

2400.000000 

2500.000000 

3500.000000 

3600.000000 


3.  OUTFILE  -  File  created  by  READER  containing  the  tailored  Statement  of 
Work.  Here  is  a  sample: 


STATEMENT  OF  WORK 


BRDEC  SOFTWARE  DEVELOPMENT  AND  SOFTWARE  QUALITY  EVALUATION 


SCOPE  OF  SOFTWARE  DEVELOPMENT  AND  SOFTWARE  QUALITY  ASSURANCE  TASKS 


General 

This  document  delineates  the  Government’s  requirements  for  scientific, 
engineering,  analysis,  and  technical  services  to  support  software  development 
and  software  quality  evaluation  for  BRDEC  (Belvoir  Research,  Development  and 
Engineering  Center)  mission-critical  computer  systems  software. 

Scope  of  Work 

The  contractor  shall  provide  all  necessary  personnel,  supervision, 
management,  materials,  services,  equipment,  and  facilities  to  perform  software 


CDRL  -  File  created  by  READER  containing  the  Form  1423  information. 
Here  is  a  sample: 


Form  1423  data:  1423  data  for  paragraph  1000.00 

BLOCK  2  —  Software  Development  Plan 
BLOCK  3  —  SDP 
BLOCK  4  —  DI-MCCR-80030 
BLOCK  6  —  STRBE-TQR 
BLOCK  7  —  DD 
BLOCK  8  —  A 
BLOCK  10  —  ONE/R 
BLOCK  12  —  See  Item  16 
BLOCK  13  —  See  Item  16 
BLOCK  15  —  Total 

BLOCK  16  —  Draft  plan  shall  be  submitted  NLT  30  days  after  contract  award. 

Allow  30  days  for  Gov’t  review/comments .  Revised  SDP  due  NLT 
30  days  after  receipt  of  Gov't  comments.  Changes/Revisions  shall 
be  submitted  as  change  pages  for  approval.  Reproducible; 
Electronic  Media. 


READER  begins  by  displaying  an  introduction  and  then  asking  the  user  some 
questions : 


Expert  Sm«  3ta  tens nt  of  Work  Translator  Program 

Copyright  1986,  McLean  Rea* arch  Center,  Inc. 

Unlimited  license  for  use  and  distribution  of  this  prograa 
is  granted  to  the  United  States  Government 


This  pi  cm  ssi  is  taking  the  9QA  Expert  Syatea  output,  which 
ia  a  group  of  SQA  paragraph  mabers  to  include  in  the  Stat— ant  of 
Work,  and  is  extracting  those  paragraphs  in  order  free  s  asster 
data  baae  of  SQA  paragraphs.  The  program  output  is  a  text  file 
which  will  be  reed  by  a  word  processor  and  incorporated  into  the 
actual  3 ta tenant  of  Work.  Also  produced  is  a  second  file,  called 
CTRL,  vhich  contains  instructions  for  ooepleting  Foma  1423  as 
directed  by  the  included  paragraphs. 


Press  <  re  turn  >  to  continue 


o  o  □ 

BRIGHT  CONTRAST  0N/0FF 


How  sany  hardcopies  of  specifications,  descriptions ,  procedures, 
reports,  aammls  and  doc>.— nts  is  the  contractor  to  deliver?  2 


What  type  of  electronic  asdia  is  the  contractor  to  eaploy  for 
his  deliverables? 

1.  f%*netic  Tbps 

2.  Floppy  Disk 

3.  Other 


Enter  Choice:  J 


What  is  the  host  systaa?  WTOE  PC 


produced . 


